home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat3 / libblas / symv.z / symv
Encoding:
Text File  |  2002-10-03  |  4.1 KB  |  105 lines
  1. SYMV(3F)                                              Last changed: 11-2-98
  2.  
  3.  
  4. NNAAMMEE
  5.      SSSSYYMMVV, DDSSYYMMVV - Multiplies a real or complex vector by a real or
  6.      complex symmetric matrix
  7.  
  8. SSYYNNOOPPSSIISS
  9.      Real
  10.  
  11.         CCAALLLL SSSSYYMMVV ((_u_p_l_o,, _n,, _a_l_p_h_a,, _a,, _l_d_a,, _x,, _i_n_c_x,, _b_e_t_a,, _y,, _i_n_c_y))
  12.  
  13.      Double precision
  14.  
  15.         CCAALLLL DDSSYYMMVV ((_u_p_l_o,, _n,, _a_l_p_h_a,, _a,, _l_d_a,, _x,, _i_n_c_x,, _b_e_t_a,, _y,, _i_n_c_y))
  16.  
  17. IIMMPPLLEEMMEENNTTAATTIIOONN
  18.      IRIX systems
  19.  
  20. DDEESSCCRRIIPPTTIIOONN
  21.      SSSSYYMMVV and DDSSYYMMVV multiplies a real vector by a real symmetric matrix.
  22.  
  23.      These routines perform the following matrix-vector operation:
  24.  
  25.           _y <- _a_l_p_h_a _A_x + _b_e_t_a _y
  26.  
  27.      where _a_l_p_h_a and _b_e_t_a are scalars, _x and _y are _n-element vectors, and _A
  28.      is an _n-by-_n symmetric matrix.
  29.  
  30.      These routines have the following arguments:
  31.  
  32.      _u_p_l_o      Character*1.  (input)
  33.                Specifies whether the upper or lower triangular part of
  34.                matrix _A is being supplied, as follows:
  35.  
  36.                _u_p_l_o= 'U' or 'u':  only the upper triangular part of _A is
  37.                being supplied.
  38.                _u_p_l_o= 'L' or 'l':  only the lower triangular part of _A is
  39.                being supplied.
  40.  
  41.      _n         Integer.  (input)
  42.                Specifies the order of matrix _A.  _n >= 0.
  43.  
  44.      _a_l_p_h_a     Scalar alpha.  (input)
  45.                SSSSYYMMVV: Real.
  46.                DDSSYYMMVV: Double precision.
  47.  
  48.      _a         Array of dimension (_l_d_a,_n).  (input)
  49.                SSSSYYMMVV: Real array.
  50.                DDSSYYMMVV: Double precision array.
  51.  
  52.                Before entry with _u_p_l_o = 'U' or 'u', the leading _n-by-_n
  53.                upper triangular part of array _a must contain the upper
  54.                triangular part of the symmetric matrix.  The strictly lower
  55.                triangular part of _a is not referenced.
  56.  
  57.                Before entry with _u_p_l_o = 'L' or 'l', the leading _n-by-_n
  58.                lower triangular part of array _a must contain the lower
  59.                triangular part of the symmetric matrix.  The strictly upper
  60.                triangular part of _a is not referenced.
  61.  
  62.      _l_d_a       Integer.  (input)
  63.                Specifies the first dimension of _a as declared in the
  64.                calling program.  _l_d_a >= MMAAXX(1,_n).
  65.  
  66.      _x         Array of dimension 1+(_n-1) * |_i_n_c_x|.  (input)
  67.                SSSSYYMMVV: Real array.
  68.                DDSSYYMMVV: Double precision array.
  69.                Contains the vector _x.
  70.  
  71.      _i_n_c_x      Integer.  (input)
  72.                Specifies the increment for the elements of _x.  _i_n_c_x must
  73.                not be 0.
  74.  
  75.      _b_e_t_a      Scalar beta.  (input)
  76.                If _b_e_t_a is supplied as 0, _y need not be set on input.
  77.                SSSSYYMMVV: Real.
  78.                DDSSYYMMVV: Double precision.
  79.  
  80.      _y         Array of dimension 1+(_n-1) * |_i_n_c_y|.  (input and output)
  81.                SSSSYYMMVV: Real array.
  82.                DDSSYYMMVV: Double precision array.
  83.                Contains the vector _y.  On exit, the updated vector
  84.                overwrites array _y.
  85.  
  86.      _i_n_c_y      Integer.  (input)
  87.                Specifies the increment for the elements of _y.  _i_n_c_y must
  88.                not be 0.
  89.  
  90. NNOOTTEESS
  91.      SSSSYYMMVV/DDSSYYMMVV is a Level 2 Basic Linear Algebra Subprogram (Level 2
  92.      BLAS).
  93.  
  94.      When working backward (_i_n_c_x < 0 or _i_n_c_y < 0), each routine starts at
  95.      the end of the vector and moves backward, as follows:
  96.  
  97.           _x(1-_i_n_c_x * (_n-1)), _x(1-_i_n_c_x * (_n-2)) , ..., _x(1)
  98.  
  99.           _y(1-_i_n_c_y * (_n-1)), _y(1-_i_n_c_y * (_n-2)) , ..., _y(1)
  100.  
  101. SSEEEE AALLSSOO
  102.      HHEEMMVV(3F)
  103.  
  104.      This man page is available only online.
  105.